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AUTHOR’S ERNEST ENTREATY 


I have done my best to offer here a quality program at a reasonable 
price. This is my livelihood. Please do not make copies of this program 
for any reason other than personal backup. Thank you. 


INTRODUCTION 


Greetings fellow ATARI Home Computer owner. I am sure you are just 
as proud of your system as I am of mine and enjoy buying accessories to 
extend its power and convenience. From that point of view, OMNIMON! is 
one of the most powerful additions you can make to your computer. Any |. 
serious ATARI owner will find it indispensible after using it for the 
first time. 


OMNIMON! is a resident machine language monitor which, once 
installed, is always available to you. What that means is that you never 


have to load it and you can call it up no matter what program happenssto 


be running at the time. Once running, OMNIMON! gives you complete,; gee. 
control over your computer. This includes the ability to easily examine 
and modify memory or the 6502's registers, to dump data to a. printers aad 
to read and write to the disk drive(s) without DOS. It also: has ats | 
complete set of debugging tools including a disassembler, singlefetep, 
and a unique JSR function for testing out subroutines. And all of these 
features are available to you at any time, no matter what program is © 
running, simply by pressing SYSTEM RESET along with either the OrILON or 


SELECT button! 


But what if you are not an assembly language programmer? What if you 
just dabble in BASIC or maybe use your computer strictly for word . 
processing? Even so, OMNIMON! can be worth its weight in gold as | 
insurance against system crashes. By allowing you to save memory off to 
'disk it can help you recover from glitches or operator errors. And if you 
have been wanting to learn assembly language programming, OMNIMON! can 
make it a very pleasant experience. Since it is ROM resident, you can 
usually get back to OMNIMON! even if your program goes berserk. You can 
even call OMNIMON! at critical points in your program to examine things 
before continuing execution. OMNIMON! is extremely user friendly so even 
programmers with little experience should find it very easy to use. 
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GETTING STARTED 


After installing OMNIMON! in your computer (if you have not done so, 
see OMNIMON! INSTALLATION INSTRUCTIONS), you should be able to powerup 
your computer as usual. To enter the OMNIMON! program, hold down the 
OPTION key and press SYSTEM RESET. This method of entering OMNIMON! wili 
cause a warmstart up to the point that the application program would 
normally be given control. Instead OMNIMON! takes control and you should 
see the OMNIMON! header written across the top of the screen indicating 
that the program is running: 


David Young OMNIMON! Copyright 1983 


PC NV=BDIZC ACCUM X-REG Y-REG STACK 
AXXxXxX xX xx pap xx XXX 


When you are ready to exit OMNIMON!, hold down the START button and type 
RETURN. This will cause the warmstart to go to completion, giving control 
back to the application program. Notice that pressing SYSTEM RESET by 
itself will cause a normal warmstart. 


Once you have OMNIMON! running, the first command to learn is the 
‘HELP* command. As is fairly standard practice in user friendly software, 
OMNIMON! uses '?' (RETURN) to give you a list of all the commands 
available. So type ‘'?' followed by RETURN and you will see the following: 


CPU/CHG:C 

DPY/CHG:D (Cadr adr) 
EXECUTE:E (byt) 

Jon ;J adr 

LINK DR:L (Cdrive#) 
PRINTER: P 

RD DISK:R (sec# adr #) 
SEARCH :S adr byt byt ee. 
TOGGLE :T 

WR DISK:W (Csec# adr #) 
DIS/CHG:X (adr adr) 
PSH STK:+ byt byt ee. 
POP STK3:- 


The HELP command not only provides a list of commands but also 
indicates the parameters each command expects. Parameters in parentheses 
are optional. If they are omitted, OMNIMON! will try to interpret the 
command in a manner convenient to you. Usually this means executing the 
command on the next logical memory location or sector. If you are anxious 
to start using OMNIMON!, you can do so immediately with just this lttle 
bit of knowledge. With a little experimentation you should have little 
trouble figuring out what most of the commands do. When you are ready to 
learn some of the more subtle features built into OMNIMON!, read the rest 
of this documentation. 
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There are a few important things to point out before proceeding: 
1) All numerical input and output is done in hex. 
2) Parameters are delimited by a space or other non-hex character. 


3) The command being processed will be aborted if an illegal parameter is 
encountered or if a necessary parameter is not supplied. - 


4) It is not necessary to retype a command if it is already present on 
the screen. Just position the cursor on the same line, make changes if 
you wish, and type RETURN. All the normal ATARI editing comma:ids are 
available. , 


5) The processing of most commands can be stopped by holding down the 
START button. This allows you to terminate a long listing, search or 
Single step. 


DISPLAY MEMORY: D (Cstart addr) (end addr) 


This command is used to view data in memory in either hex or 
character format, depending on the current data format (see TOGGLE). In 
hex format the data is output to the screen as 1 or more lines of 8 hex 
bytes separated by spaces. In character format the data is output as l or 
more lines of 24 byte character strings. On each line, the addres: of the 
first byte precedes the data. 


In either data format the letter ‘At is appended to the start of 
each line. This in fact represents the ALTER MEMORY command (see the 
following command description). The effect is that, once you have used 
'D' to display part of memory, you can alter any byte(s) by simply 
positioning the cursor, typing the change(s), and’ hitting RETURN. You. 
must type RETURN on each line that you alter for the change to take 
effect. Also, the current data format must match the way the data was 
represented on the line. One other limitation in the character mode is 
that a line containing the character representing $9B is not alterable 
past that character. The OS cannot handle a record with an imbedded $9OB. 
If you wish to alter a line after a $9B character, redisplay the line 
Starting just past it. 


To display memory, type ‘D' followed by optional start and stop 
addresses and then RETURN. You can display up to 32K bytes ($8000) with 
one command. If you omit the stop address, only a single line of data 
will be printed. If you omit the start address, the next logical line of 
data will be printed (either the next 8 or 24 bytes of memory, depending 
on the data format). One last convenience is that once you have used the 
"D* command, OMNIMON! will default to that command if you just type 
RETURN. This allows you to scroll through memory by holding down the 
RETURN key. This default will remain in effect until one of the other 
‘persistent' commands (R or X) are used, at which time they wiil become 


the default. 
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TOGGLE DATA FORMAT: T 


As mentioned previously, all numerical data is represented in hex. 
However, when dealing with ASCII text it is more convenient to work in 
character format. The TOGGLE command (T) is used to switch between hex 
and character format. It affects three commands: ALTE® MEMORY (A), 
DISPLAY MEMORY (D) and SEARCH MEMORY (S). Other commands are unaffected 
by the current data format. , ) 


To switch data formats type ‘'T' (RETURN). Upon first entering 
OMNIMON! the data type defaults to hex. 


ALTER MEMORY: A addr byte byte ... 


This command is used to change 1 or more contiguous bytes of memory. 
You can type the change either as hex bytes (separated by spaces) or as 
ATASCII character strings, depending on the current data format (see 
TOGGLE). While it is possible to use the ‘A‘* command by itself at any 
time, it is not recommended. To display the area of memory first with 
the 'D* command and then to position the cursor and make the change is 
much safer (see DISPLAY MEMORY). This way you not only verify that the 
memory at that location is the memory you intended to change, but also 
that the current data format is compatible with the data you are typing. 


To use the ALTER MEMORY command, type ‘A‘' followed by an address. 
Use a space to separate the address and the data and then start typing 
the data. If in hex format, type hex bytes delimited by spaces. If in 
character format, type a continuous character string. Terminate the . 
command with RETURN. At that point the indicated changes will be made. 
The command line can be as long as you like or until the computer 


squawks. SQUAWK! 
SEARCH MEMORY: S addr byte byte ee. 


Searching is something that computers do very well and OMNIMON! has 
a very nice search function that works in either hex or character mode. 
It will scan memory for any sequence you specify and display it ina 
manner similar to the DISPLAY MEMORY command every time it is found. This 
means you can alter any occurrence of that sequence by simply positioning 
the cursor, typing the change and hitting RETURN (see DISPLAY MEMORY). 


Even though it only takes a few seconds to search all of memory, a 
search can be aborted by holding down the START button. The search can 
then be resumed where it left off by typing 'S (RETURN)* but only if 
there have been no intervening commands. 


To use the SEARCH MEMORY command, type 'S' followed by the address 
where you would like the search to begin. Then type a space followed by 
the search sequence. This will be hex bytes separated by spaces in hex 
mode or a character string in character mode (see TOGGLE). The search 
will begin when you hit RETURN. The search sequence can be any length up 
to the limit of the ATARI terminal input buffer (squawk). 


: 
%t 
2 














OMNIMON! USER'S GUIDE 


PRINTER ON/OFF: P 


If you want a hardcopy record of your OMNIMON! sessaon, you can use 
the 'P* command to cause anything. being output to the screen to be echoed 
to the printer. In character mode, inverse videe characters are printed 
as normal video and unprintable characters ure cranslated to dashes (-). 
Otherwise, everything on the screen will show up on the printer. There is 
even a special single step mode (see EXECUTE) that will trace through a 
program while outputting only to the printer and not to the screen. This 
is useful for programs that use the screen in modes other than GRAPHICS 0O. 


The 'P* commmand is a toggle function. Typing it once will enable 
output to the printer and typing it again will disable output. If the 
printer is not turned on or selected, the message ‘I/O ERROR' will 
result. Care should taken if the printer is enabled while reading or 
writing to the disk (see READ DISK or WRITE TO DISK). 


DISK INPUT/OUTPUT 


Anyone who owns my disk utility DISKSCAN knows how useful Le 2s £0 
be able to edit raw sector data on a disk. One of my goals in designing 
OMNIMON! was to incorporate some of the features of DISKSCAN. Imagine, a 
resident mini-DISKSCAN! 


Well, the end result has far exceeded my expectations. With OMNIMON! 
you can not only read and write individual sectors, but multiple sectors 
to and from anywhere in memory. And it not only works in sequential mode, 
but it can also follow sector links. In fact, you can read in an entire 
DOS file from a disk without even booting up pOoS! And the frosting on the 
cake is that OMNIMON! works equally well in single or double density, a 
dream come true for the growing number of double density drive owners. 


LINK/SEQ MODE & DRIVE #: L (drive#) 


When you first enter OMNIMON!, the program assumes that you wish to 
talk to drive #1 and that the sector mode is sequential. If you wish to 
talk to other drives or follow sector links, use the LINK command to put 
OMNIMON! in the correct mode. The LINK command is actually two commands 
in one. When used by itself (without a parameter) ‘L* means to toggle 
from sequential to linked mode or vice versae When followed by a drive # 
(1-4), ‘L' means to switch the drive ID to the specified drive. From that 
point on, all disk I/O will be directed to that drive. 


To toggle between the sequential and linked sector modes, type “7, 
(RETURN)*.To direct disk 1/0 to a different drive, type ‘L' followed by 
the drive # and RETURN. 
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READ DISK: R (sector#) (Cbuffer addr) (# sectors) 


The READ DISK command is one of the most powerful, user friendly 
functions of OMNIMON!. It can be used to read one or more sectors, either 
sequentially or linked, from any disk drive, singie Or double density. We 
will start out by using the READ DISK cominand to read one sector at a 
time. You will find it behaves somewhat differently when operating on 
more than one sector at a time. | ; 


To read a single sector into memory type ‘R‘ followed by the sector 
# and RETURN. OMNIMON! will assume a buffer address of $6000 unless you 
specify something different after the sector #. From that point on 
OMNIMON! will assume that new buffer address for subsequent disk TI 0% 
Once you have the sector in memory you can operate on it with any of the 
other OMNIMON! commands including DISPLAY, ALTER, SEARCH, DISASSEMBLE, 
etc. One convenient feature is that, after a READ DISK command, OMNIMON! 
will assume the buffer address if you use ‘DD’ or 'x' without a start 
address. (Try typing 'D (RETURN)' after reading a sector into memory). 


Now, if you wish to read the sector which logically follows the last 
sector read into memorys type ‘R (RFTURN)*. In sequential mode, the next 
physical sector on the disk will be read. In linked mode, OMNIMON! will 
reference the sector link of the current sector to determine the next 
sector to read. In either case, the new sector will be read into memory 
at the SAME buffer address; overlaying the old sector. | 


NOTE: IF THE PRINTER IS ENABLED WHILE READING SINGLE SECTORS, THE SECTOR 
# AND BUFFER ADDRESS MUST BE SPECIFIED EACH TIME. This is because the 
printer and disk share the SIO DCB (Device Control Block). 


Ready for a couple more examples of user friendliness? One is that 
the ‘R' command, like ‘np’ and ‘X*, is a ‘persistent’ command. That means 
that once you use the "R* command, OMNIMON! will default to that command 
if you just type RETURN. This default will remain in effect until one of 
the other persistent commands are used. What this means is that you can 
read through an entire File (or disk, .if in sequential mode) by reading 
the first sector and then simply holding down the RETURN key. One other 
convenience is that OMNIMON! will not read past the end of file if it is 
in linked mode. Thus, if you were reading through a file as suggested 
above, simply hold down the RETURN key until ‘EOF’ is printed. At that 
point, the last sector of the file is at the buffer address. You are free 
to add something to the end of the file (perhaps an autorun vector) and 
then to write the sector back out with the WRITE SECTOR command. 


Reading multiple sectors is somewhat different from reading single 
sectors. For one things the sector #, buffer address; and sector count 
must be specified each time. The other difference is that, instead of 
consecutive sectors overlaying each other, the buffer address is 
incremented between sectors so that the disk data fills memory. The exact 
amount by which the puffer address is incremented depends on the sector 
mode and the density of the drive. The effect is that in sequential mode 
all bytes of the sector are preserved, while in linked mode the sector 
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links are overlayed. This is a desirable feature if you want to read an 
entire DOS file into memory. If you find this discussion confusing, it is 
recommended that you read my tutorial on ATARI DISK DATA STRUCTURES in 
the DISKSCAN USER'S GUIDE or the MARCH 1982 issue of COMPUTE! magazine. 


An example may be of help. Fizst, put OMNIMON! in character mode 
with ‘'T* and sequential mode with ‘L'. Now type 'R 169 6000 8°. This will 
read in the 8 sectors of the directory into the buffer at $6000. Now type 
'D’' followed by several RETURNs. You will be able to read the names of. 
the files on the disk. Choose a filename, put OMNIMON! in hex mode with 
'T', and use 'D addr‘ to display the 5 bytes just prior to the filename. 
The first byte is the status while the next two are the size of the file 
and the next two are the start sector. Now put the program in linked mode 
with ‘L'. Read in the entire file with 'R (start sector) 6000 (file 
size)'. Type 'D' and hold down the RETURN key to scroll through the data 
of the file. 


If the file happens to be a BINARY LOAD file, a slight Variation of 
this technique is recommended. Instead of specifying an arbitrary buffer 
address of $6000, look at the first sector of the file to determine the 
load address. Then subtract 6 bytes to account for the load vector and 
use that number as the buffer address. Then, after the file is loaded, it 
can be executed, searched, disassembled or otherwise manipulated to your 
hearts content. Notice that the entire program will be loaded to the 
correct place in memory only if there is but one load vector at the 
beginning of the file. OMNIMON! as a rule ignores load vectors. If you 
must load a file with multiple load vectors, use DOS. 


Once you have a binary load file in memory you can create a boot 
disk by switching over to sequential mode and writing the program back 
out to a disk starting at sector 1. You will need to leave 6 overhead 
bytes at the beginning of the first sector. See the ATARI OPERATING | 
SYSTEM USER'S MANUAL for details on the boot process. The converse of 
this process would be to create a binary load file from a boot record. 
This can be done by first booting up DOS, going to OMNIMON!, and reading 
in the boot record in sequential mode to a convenient place in memory. 
Then you would exit back to DOS and do a BINARY SAVE on that portion of 
memory. Then you may have to use OMNIMON! to change the load vector at 
the beginning of the file to make it load in at the correct place. In 
fact, you may have to use OMNIMON! to load the file if it loads on top of 


DOS. 


One final convenience is that each time a single sector is read, its 
# is printed along with the buffer address. This also occurs when 
multiple sectors are read, but only when the printer is on. Thus, if you 
read in an entire file with the printer on, you get a sector map of that 
file. Now if, while inspecting the file in memory, you find that you wish 
to make a change to the file on disk, you can compare the buffer address 
to the sector map of the file to determine the sector where that piece of 
data resides. Then you can use ‘R seci#t' to fetch that sector, make the 
change, and use ‘W sec#* to store the sector back on disk. 
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WRITE TO DISK: W (sector #) (buffer addr) (# sectors) 


The WRITE TO DISK command allows you to write one or more sectors 
worth of memory out to disk. The one big difference between it and the 
READ DISK command is that it only works in the sequential mode. That 
means that it will not creace a DOS file, i.e., it will create neither a 
directory entry nor sector links. If you do wish to create a POS file out 
of memory it is best to use the BINARY SAVE option of DOS. However, it is 
not always possible to get DOS into memory without losing your data. In 
this case, OMNIMON! may be the only way save your data. If you do wish to 
create a DOS file out of the memcry you have written to disk with 
OMNIMON!, use the BINARY LOAD FILE function of DISKSCAN in the sequential 
mode. This feature of DISKSCAN will pick up sectors and redeposit them as 


a DOS file. 


IMPORTANT: Use a scratch disk when writing multiple sectors worth of 
memory to disk with OMNIMON!. The program pays no attention to data 
already on the disk and may overlay Lt 


The primary purpose of the WRITE TO DISK command is to support the 
modification of one sector at a time. A typical scenario is as follows: 


Turn the printer on, read a file into memory as 
described in READ DISK, and turn the printer off. 
Search the file to find the data to be changed. 
Compare the address of the data in memory to the 
sector map created while the file was being read ine 
Read that particular sector into memory with ‘R 
sec#*. This insures that you not only have the data 
of the sector but also the sector link. Then alter 
the sector and write it back out with ‘W sec#'. 


Another application for the WRITE TO DISK command would be to move a 
block of memory from one location to another. This is accomplished by 
writing the data out from one buffer address and reading it back in at 
another. It is important to use a scratch disk for this operation or at 
least be very careful that you are writing to an unused portion of a disk. 
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ADVANCED TOOLS 


We have seen how to enter OMNIMON! by holding down OPTION and 
pressing SYSTEM RESET. This causes a normal warmstart followed by a jump 
subroutine (JSR) to OMNINON!. When you exit OMNIMON! after entering it in 
this way (by holding down START and pressing RETURN), the warmstart goes 
to completion in a normal fashion. This is fine for some applications but 
there is actually a better way to enter OMNIMON! which disturbs the 
program running as little as possible. 


When you hold down SELECT and press SYSTEM RESET, the program 
running at the time is interrupted. However, instead of doing the entire 
warmstart, parts of it are skipped over so as to preserve the state of 
the system as much as possible. Specifically, the OS variables and the 
stack are left undisturbed. Usually this allows you to reenter the 
program by simply exiting OMNIMON! in the normal fashion. For instance, 
you can pop into OMNIMON! from either DOS or BASIC, execute some OMNIMON! 
commands, and pop back into the interrupted program almost as if you had 
never left it. I say ‘almost' because the OS is likely to return a bogus 
value if it was waiting for a keystroke when it was interrupted. For that 
reason it is best to hit BREAK upon return to the program. Of course, if 
the program makes use of any graphics other than MODE QO, it is unlikely 
that you will be able to sucessfully reenter the program without 
restarting it. This is also true of programs which alter the interrupt 
RAM vectors ($200-$224) because OMNIMON! restores them to their original 


values. 


Another way to enter OMNIMON! is particularily useful for debugging 
assembly language programs. This is accomplished by putting ‘JSR SCOoGL* 
at critical points within the program. At each of these points OMNIMON! 
will be entered and you will have all of its facilities available for 
examining the intermediate results of your program. When you are ready to 
continue executing your program, just exit OMNIMON! with START/RETURN. 
There are some restrictions on this technique however, specifically 
special graphics and time critical I/0. 


Yet another way to enter OMNIMON! is from BASIC with a 
'X=USR(49152)'. In fact, this is the recommended way to enter the monitor 
if you have not modified the interrupt vectors at $FFFA-$FFFD as 
described in the OMNIMON! INSTALLATION INSTRUCTIONS. You can exit back to 
BASIC in the usual manner (START/RETURN). 


It should also be pointed out that OMNIMON! will be entered 
automatically if a 6502 BRK instruction (0) is ever executed. Thus, you 
can set a breakpoint anywhere in your program by storing a 0. When you 
pop into OMNIMON! after executing a BRK instruction, you should restore 
the original instruction and subtract 2 from the PC. Now you can continue 
executing your code when you exit OMNIMON!. 
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CPU REGISTERS: C 


You will notice that, upon entering OMNIMON!, the 6502's internal 
registers are printed out with the following heading: 


PC NV-BDIZC ACCUM X-REG Y-REG STACK 


The meanings of these headings are self-explanatory except for 
‘NV-BDIZC'. These are the individual bits of the status register spelled 
out. Thus, this is a snapshot of the state of the CPU just prior to 
entering OMNIMON!. The PC (program counter) is pointing to the next 
instruction to be executed. The program will continue executing at this 
point when ycu leave OMNIMON! with START/RETURN. 


The CPU state can be examined at any time with the CPU REGISTERS 
command 'C'. In addition, the CPU state can be changed by simply 
positioning the cursor over the value, typing the change, and hitting 
RETURN. The new values for the registers will be in effect when you leave 
OMNIMON! to resume execution of the suspended program. The only CPU 
register that cannot be changed directly is the stack pointer. This can 
be changed only by the PUSH STACK (+) and POP STACK (-) commands. 


One application for the ‘C* command is to GOTO anyplace in memory. 
This is accomplished by altering the PC to point to the address where you 
wish execution to resume when you press START/RETURN. Typically this 
might be back to DOS, whose address can usually be found by looking in 
location $000A (DOSVEC). 


Another area of interest is the stack. Remember, the stack pointer 
always points to the next FREE entry. All the values between the stack 
pointer and $l1FF are typically return addresses of nested subroutine 
calls. This, in fact, is a vertical cross section of the execution 
history of the program. This is extremely useful for finding your way 
around in a program you wish to modify in some way. If you wish to to 
locate the part of a program which is performing a certain function, just 
start the program executing that function and press SELECT/RESET. Because 
the stack is preserved with this method of entering OMNIMON!, you can 
tell where the program is and where it has been by noting the PC and the 
return addresses on the stack. Another way of locating a certain piece of 
code is to search ('S‘') for a particular address it might reference. 
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PUSH STACK: + byte byte ... 


The PUSH STACK command is for adding bytes to the stack and thereby 
increasing the stack pointer (which grows downward in the 6502). These 
bytes will be available to the code pointed to by the PC when OMNIMON! is 
exited. Notice that the first byte after ‘t+' is the first one to be 
pushed onto the stack. 


Please note that the stack pointer displayed with the 'C* command is 
not the ACTUAL stack pointer while OMNIMON! is running. OMNIMON! uses the 
stack for its own purposes and is actually nested somewhat deeper. Li “is 
not wise to make changes directly to the stack unless you use PUSH STACK 
or POP STACK. Even then you must be careful not to cause the stack to 
overflow or underflow. 


POP STACK: = 


The POP STACK command takes bytes off of the stack one at a time and 
decreases the stack pointer (which actually increases in value). Be 
careful to not cause the stack to underflow. 


DISASSEMBLE MEMORY: X (start addr) (stop addr) 


Just as it is possible to display memory in hex or character format, 
it is also pussible to translate 6502 machine code to assembly language. 
OMNIMON! does this in a handy fashion by printing out the object code 
along with the instruction. Once again, it is possible to change the 
object code (to the left of '*") by positioning the cursor, typing the 
change, and hitting RETURN. Another convenience is that the value at the 
address specified with indirect addressing modes is printed. in 
parentheses. 


Just like the 'R' and 'D' commands, ‘X*' is ‘persistent’. Once you 
have disassembled one or more instructions, you can continue 
disassembling simply by holding down RETURN. This will remain in effect 
until 'R' or 'D*' are used. The disassembler can be aborted at any time by 
pressing the START button. 
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EXECUTE MEMORY: E (Coption/# steps) 


d 

The EXECUTE MEMORY. command is actually a single step command in 
disguise («‘'S* is used for SEARCH). This command causes the instruction 
pointed to by the PC to be executed. Then the registers are printed out 
along with the NEXT instruction to be executed. If the step count was l 
(or not specified) then execution will stop. Otherwise it will continue 
single stepping through the code for the specified # steps. The maximum 
number of steps is 3l for reasons soon to become clear. 


While the low order 5 bits of the optional parameter are a step 
count, the high order 3 bits have special meaning. The MSB means ‘step 
forever’. Thus, "E 80* means ‘step forever and print the trace to the 
screen’. Notice that the trace will also be echoed to the printer if it 
is enabled. Stepping can be aborted by pressing START. 


Bit 6 of the parameter means ‘don't print the trace to the screen'. 
However, the trace will still be output to the printer if it is enabled. 
Thus, ‘E CO' would step forever without printing the trace to the screen, 
In combination with the printer this is useful for stepping through 
programs which use special graphics modes. 


Bit 5 of the parameter means ‘sample the results of every 32 
instructions’. Thus, 'E EO* would step forever without printing to the 
screen and the trace would be output to the printer every 32nd 
instruction (if it is enabled). This is kind of a wierd mode, but 
somebody may find a use for it someday. 


One other nice feature of the ‘E" command is that it will treat a 
call to the OS as a single snstruction instead of stepping through all 
the code in the OS. OMNIMON! does this by temporarily giving up control 
of the CPU but intercepting it on the return from the OS. However, you 
should avoid stepping through CIO calls to the screen editor (E:) unless 
printing to the screen is disabled with bit 6. OMNIMON! considers any 
address above $C000 to be OS. 


We have seen that the EXECUTE MEMORY command is very powerful and 
Flexible. One restriction, however, is that it will not step through a 
'SEI' instruction. If you are stepping through a program and encounter a 
SEL, disassemble on past it to find the 'CLI'. Just past the CLI put a 
temporary BRK instruction (0). Now step through the SEI. OMNIMON! will 
temporarily lose control of the program but will regain it when the BRK 
instruction is executed. Now restore the original value to the location 
where the BRK was set. After subtracting 2 from the PC you are ready to 
continue stepping. 


OMNIMON! makes use of the SIO interrupt routines in the OS ROM by 
altering the interrupt vectors at $20A-$20D. This is so the printer and 
disk interface of OMNIMON! will work even if DOS is not in memory. If you 
wish DOS to restore its special vectors, exit OMNIMON! with SYSTEM RESET. 
I have noticed no difference in DOS' behavior with the ROM SIO handlers 
installed. | 


| Die 








A ta ty are 


OMNIMON! USER'S GUIDE 


JSR: J addr 


The JSR command is a very powerful feature for executing a 
subroutine and returning control back to OMNIMON!. It can be used for 
testing out subroutines during the development of an assembly language 
programe. With some care it can also be used to call the OS toO, Say, 
format a disk. 


When you execute the ‘J* command you will notice that the registers 
are printed out but that the Subroutine is not yet executed. In fact, the 
°“J* command does nothing more than change the PC to the specified address 
and push the address of OMNIMON! on the stack to act as the return 
address for the subroutine. Now you are free to set up for the subroutine 
call by altering the registers or memory if necessary. When you are ready 
to actually execute the subroutine press START/RETURN. Upon return you 
will notice that the PC is restored to its original value but that the 
other registers reflect the results of the subroutine. 


As an example, put a fresh disk (or one you don't mind formatting) 
in drive l. With the printer disabled, store a l1 in $301 and a $21 in 
$302. Now execute a ‘J E453" and press START/RETURN. The disk in drive l 
will be formatted and then control will be returned to OMNIMON!. 


Sometimes after interrupting a program with OMNIMON!, you will not 
be able to restart it without reinitializing it. The start and 
initialization addresses for a program are typically at $000A and $O000C 
respectively. Since a proper initialization routine is always a 
subroutine, you can use ‘J (init addr)’ to initialize the program. When 
control returns to OMNIMON!, you need only change the PC to the start 
address and exit OMNIMON! with START/RETURN to restart the program. 


QUESTIONS? 
I welcome comments, suggestions and dealer inquiries: 
DAVID YOUNG 
CDY CONSULTING 
421 HANBEE 
RICHARDSON, TX 75080 
LIMITED WARRANTY 
For a period of one year following the date of purchase CDY 


CONSULTING will repair or replace any OMNIMON! unit proven to be 
defective. Please return the defective unit to the place of purchase. 


ee 








OMNIMON! INSTALLATION INSTRUCTIONS 


NOTE: If you purchased OMNIMON! installed in the ‘*Vitamin-C* OS 
piggy-back board, ignore this sheet. Instead, refer to the installation 
instructions provided with ‘Vitamin-C’". 


The OMNIMON! program comes in a 2732 EPROM. This can be installed 
only in special hardware such as RAMROD MMOS by NEWELL INDUSTRIES which 
accepts a 2732 in the $C000 block of memory. Follow the instructions 
provided with this hardware for installation of the chip. 


To make sure the installation is correct up to this point, power up 
the computer. If everything appears to be normal, try entering OMNIMON! 
from BASIC with a ‘X=USR(49152)'. If it fails this test then double check 
the installation of the chip. If this works properly then proceed with 


the next paragraph. 


For proper operation of OMNIMON! the following locations should be 
changed in the OS (assuming your OS is in EPROMS): 


$FFFA-$FFFD - $CE,$CF,$F5,$CF 


This allows the SELECT and OPTION keys to work in conjunction with SYSTEM 
RESET for entering OMNIMON!. If you do not make this mod then it is 
possible to enter OMNIMON! from BASIC with '‘X=USR(49152)'. However, this 
is less convenient than the SELECT/RESET or OPTION/RESET technique, which 
interrupts any program which may be running. 


If the system fails to power up after you have made these mods then 
the mods were not done correctly. When dcne correctly the system should 
power up normally and you should be able to enter OMNIMON! with | 
SELECT/RESET or OPTION/RESET. Installation of OMNIMON! is now complete. 
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RAMROD MMOS 
CUSTOM OPERATING SYSTEM BOARD 


NEWELL INDUSTRIES 


FOR THE ATARI 800* 


Figure 1 
COMPONENT LAYOUT 


210 DESIGNED BY 
SYSTEM 
INNOVATIONS FOR 
[ze zy fx) fx, [x] NEWELL IND. 
fey fr. EY fr. RS 
(x, fu O fu © ~Sopeet 8S 
QQ Oz Oo = C14 
' 1 H ur C5 
(7) © oS = 
2 S fa © fa 2 
Q O vy) Ow i lil C16 
—C__}- 





eae aE Se 
b. ee ie C9 z5 
. SF cio 
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RAMROD MMOS 


IF ALL SWITCHES ON S2 ARE IN THE OFF POSITION, THE RAM OR ROM IN SOCKET Z® 
WILL BE MASKED FKOM THE SYSTEM. 


INSTALLATION 





In all cases, the component side of the board FACES THE BACK OF THE 
COMPUTER and ALL I.C.'s HAVE THE NOTCHES FACING THE OUTWARD EDGE OF THE BOARD, 

Take the ramrod board after you have configured it and push it into the 
socket where the original operating system board was. This method allows free 
alr movement around the componertts for better heat dissipation. If the board 
joes not stand up straight after installation, this indicates that the socket 
on the motherboard is misaligned, and it should be corrected to insure trouble 
free operation. DO NOT POWER UP THE COMPUTER if misalignment causes the board 
to touch the metal casing of the computer. 


WARRANTY 





This product is warranted for a period of one year from date of purchase 
igainst defects in material and workmanship. Fill out warranty registration 
ind return to Newell Industries within ten days of purchase to validate this 
warranty. 


GENERAL INFORMATION 





As you can see from the previous information, you have purchased a_ very 
flexible piece of equipment. Although the additional 4K of address space for 
ram Or rom will be of great benifit to most people, we believe that the option 
9f being able to modify your operating system or create your own is the most 
nowerful feature of the RAMROD OS board. Because the OS is the controlling 
factor of the comouter, it would be possible to put your software in this 
location that would immediately be present on power up with no loss of ram for 
Drogram storage. 

Some of the more simple changes would be to change some of the default 
parameters of the OS. These would include screen colors, margins, character 
set, messages, and what takes control of the system on power up. Someone may 
want DOS booted all the way, regardless of the cartridge('s) installed. 

If there are any bugs in your current OS, you will be able to try and 
correct them. If you come up with a patch to correct a bug, write about it, 
there are several magazines that would be interested in publishing this type 
of information. 


MODIFYING YOUR OS 





There are several different methods for doing this, we will discuss a 
couple of these. 

Since your current OS is now in rom where it cannot be changed, we must 
get it to ram or disk where we can change it. This is really a very simple 
task to accomplish. DO NOT use DOS to save any ROM based memory locations. 
Because of the way burst IO works, all you will get is a file that will not 
load. If you already have an EPROM programer, more likely than not you will be 
able to change it's buffer locations and save the buffer to disk. Then using 
any of the availible disk editors you can change all or part of the code. You 
would then use an Eprom programer to write your new or modified OS into Eprom. 

Another method would be to use the debuq feature of an assembler/cditor, 
move the code to ram, modify the part you want, and then save it to disk. At 
this point all you would need to do would be to use an Eprom programer to 
write your new OS into EPROM's. This would seem to be the easiest and most 


versatile method because of the speed with which you can work with ram. 
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RAMROD MMOS 


EPROM REQUIREMENTS 





1.4K EPROM - 2732 sty‘e pinout; 350 ns. max. access time 
2.2K EPROM - 2716 style pinout, 350 ns. max. access time 


RAM_ REQUIREMENTS 





2716 compatible pinout, 2Kx8 bit static ram, 250 ns. max. access time, 70 
ma. max operating current 


OPERATING SYSTEM MODIFICATIONS 





Here are a few changes you will want to make. These changes are for the 
REV. A or B roms, with the REV. B rom locations in parentheses. 

First we will start with a one byte change at location E88E(E869). The 
Original value is 6, and this controls the time interval for the repeat 
function of the keyboard. By changing this location to 3, the cursor will move 
twice as fast for repeating characters. This also means cursor movements using 
the control keys. This means faster editing of programs, because it is the 
O.S. it means twice the speed on any program, word processors, spreadsheets, 
etc. You will really like this change. 

Next we will attack the debounce feature. At this time we will also 
shorten the time for the repeat feature to work. For this we wil] have to 
change two bytes. First at location FFE3(FFE3) change the 3 to a l. This cuts 
the time by 2/3 but still operates without any problems. Next, change the byte 
at location FFEC(FFEC) from HEX 30 to 10. This will allow the repeat key to 
operate a lot faster. Two seconds is a long time when you're trying to move 
the cursor to edit something or just wanting to print a row of dashes. These 
three changes will approximately double the speed of the kevboard response 
time. 

This next mod will shorten the warning bell. There are a couple of ways to 
do this. I took the one that will also shorten the click. At location 


- FCD9(FCD9), change the value from 7F to 3F. This will cut the bell (buzzer?) 


time by more than 1/2. This still gives you plenty of time to quit typing 
before getting to the end of the line. This still allows for a click that you 
can hear when you hit a key. If you want to get rid of the click altoncther, 
change the locations starting at FOFB(F6OFB) from 20,D8,FC to EA,FA,FA. This 
NOPs the JSR to the click routine. With these changes, even the fastest typist 
shouldn't miss getting any keystrokes. 

A few other simple changes are left margin default at location F174(F174) 
(now 2), right margin at location F178(F178) (now max at hex 27 [3°]), default 
color tables starting at FECI(FEC1) thru FEC5(FECS5), memo pad message starting 
at FOF3(FOF3) thru FIOB(F10OB), boot error message starting at FIOD(F10D) thru 
F116(F116). 

These next patches will increase the cassette baud rate to approximately 
885 baud from the current 600 baud. Also we will change the leader time from 
20 seconds to about 10 seconds. This should give you about 50% faster load 
times on programs saved after these patches are implemented. This will also be 
compatible with the current 0. S., so you will still be able to read old 
tapes, and people reading your tapes will have the benefit of the increase in 
speed. Note that the hardware will not support a baud rate much higher than 
what we will use. Experiment at your own risk, 

CHANGES: 

EBBA(ERR6) from CC to WO (lo byte of write record baud rate) 
EBBF(EB8B) from 05 to 04 (hi byte) 

EFA2(EFA2) from CC to 00 (baud rate in open routinc) 
EFA7(EFA7) from 05 to 4 (hi byte) 

EFBB(EFBB) from 04 to O02 (leader time in open routine) 
EF42(EF42) from CC to O00 (baud rate in init routine) 
EF47(EF47) from 05 to 04 (hi byte) 
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RAMROD MMOS 


These are some chanves that may be helpful. If you have 2 patch that 
would like to share with others, drop us a letter and we will pass it on. 
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RAMROD MMOS 


IMPORTANT INFORMATION 





READ THIS before you install your new RAMROD board in your computer. 

First we will discuss the layout of the board. Referring to fig. 1 notice 
there are five 24 pin sockets numbered Z6 thru Z10 at the top of the board. 
Also note the two dip switches towards the bottom of the board labeled S]_ and 
S2. Now being familiar with these locations, we will give detailed information 
about each one. 


SOCKETS 





263: 

This socket is addressed as memory locations FOOO-FFFF by the computer. If 
you are using the operating system ROMs from your Original board, remove the 
CO14599 ROM from A401 of the old board and install it in this location. Refer 
to $1 switch settings for proper operation. 

Z7?% 

This socket is addressed as memory locations EOOO-EFFF by the computer. If 
you are using the operating system ROMs from your Original board, remove the 
CO12499 ROM from A403 of the old board and install it in this location. Refer 
to Sl switch settings for proper operation. 

Z8% 

This socket is addressed as memory locations D800-DFFF by the computer. 
This is the floating point ROM. Remove the CO12399 or FASTCHIP ROM from the 
old board and install it in this location. There are no switch setting 
requirements for this location. 

THE OMNIMON! ROM MAY BE SHIPPED IN 28. 
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REMOVE AND INSTALL IN Z9 FOR PROPER OPERATION. 
Z9 and 210: 

These sockets are addressed as memory locations COOO-CFFF by the computer. 
These are the memory locations that are not currently addressed by the stock 
machine. Refer to S2 switch settings for proper operation. If you ordered 
memory for these locations, your board should come with the switch settinas 
correct. 
z9 and Z10 Options: 

1.Z9-2K RAM, Z10-2K RAM 

2.Z9-2K RAM, Z10-2K ROM or EPROM 

3.Z9-2K ROM or EPROM, Z10 2K RAM 

4.Z9-2K ROM or EPROM, Z10 2K ROM or EPROM 

5.Z9-4K ROM or EPROM, Z10 BLANK 

6.Z9-BLANK, Z10 BLANK 


SWITCH SETTINGS 





Sli: 
Z6 and 27 ROM EPROM a 
1 on 1 off - “7 A ‘a y 3 C NAA. 
2 off 2 on 2 \2 
3 on <2 OEE ‘ 
4 off 4 on 7° x 
5 off 5 on #: le SrATIC 
6 on 6 off aa ; 
+ oft 7 on VS$U mee Mec vyds 
8 on 8 off ie 
$2: Z9 and Z10 control. 
Z9 4K EPROM Z9 and Z10 RAM or 
OMNIMON ! 2K RAM , 2K EPROM 
1 off 1 on 
2 on 2 off 
3 off 3 on 
4 on 4 off 
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The following mod are for the "B" OS roms only- This will allow the use of 
either OMNIMON! (SUPERMON! ) or ram in the C000 block of memory without having 
to ghange the OS roms for either. If this mod is implemented, disregard the 
OMNIMON! instructions to change the vectors at FFFA. 


{pA-# 
JMP $F125 BeK__ —* SA 
PLA LpA-th— 


E915 4C 25 Fl 
PEI18 68 





LDA $Cc000 
CMP #$68 rrr p 
BNE $E915 
JMP $CFF5 


£930 AD 00 CO 
£933 C9 68 


£935 DO DE 
£937 4c F5 CF 


* 
* 
£919 4c 99 EV * JMP $E799 | Onp—_BCH 
E91C 2C OF D4 * BIT $D40F — INTERRUPT 
EQIF 10 03 * BPL $E924° | [DA 68 co 
F921 6C 00 02 * JMP ($0200) 
£924 48 * PHA exe GA 
£925 AD 00 CO * LDA $Cc000 
£928 C9 68 * CMP #$68 Bcs LI 
_-£92A DO _EC * BNE $E918 arA GA 
E92C 68 * PLA ) LA amp rEDe 
* 
E92D 4C D6 CF * JMP §$CFD6 > errC RR 
* 
* 
* 


New vectors: 


FFFA 1C, FFFB E9, FFFC 30, FFFD E9 









OMNIMONA! 
For Advanced Users 


fera SUCCEED | UL CELL ~~) X- 





By deleting. the HELP command and shortening the user messages, room 
was freed up for a few more desirable commands and useful features. 
This document describes these additional features. Please refer to 

the OMNIMON! USER'S MANUAL for a description of the standard version 
of the monitor. A copy of OMNIMONA! can be acquired by sending a 350nS 
2732 EPROM + $2.00 postage or $10.00 to CDY Consulting, 421 Hanbee, 
Richardson TX 75080. OMNIMONA! can be freely copied for dissemination 
among the community of OMNIMON! users. ; | 


1) Hex converter: H # 


+ Can be either in hex or decimal. Decimal #'s are terminated 
with a non-hex character. For example, ‘'H1OOT' yields ‘$64 = 100'. 


2) Verify memory: V addr#l addr#2 #bytes 


Compare the specified # bytes starting at the two blocks of memory 
specified by addr#l and addr#2. Print the differences. 


3) Happy upload and download: 


If the disk is read or written to with a sector # of $800 or 
greater, the Happy drive treats the sector # as an internal buffer 
address ($800-$13FF). On multiple reads or writes the sector + 

is incremented by $80 each sector. This is not only useful for 
programming the Happy drive but is also handy for storing stuff 

On a temporary basis. 


4) RESET mod: CR |22 | R Sb 


There is support for the hardware mod which hooks the SYSTEM 
RESET switch into the RESET line of the CPU. This is accomplished 
by inserting a 47 ohm resistor into the pads provided on the 
motherboard near CRl@s and Rt63. A momentary switch to connect 
the resistor is also needed unless you wish to do a coldstart 
everytime SYSTEM RESET is pressed. With this mod and OMNIMONA! 

it is possible to recover from a system lockup. This is accomplished 
by pressing the momentary switch and pressing SELECT/RESET. This 
will pop into the monitor with the PC reflecting the instruction 
the CPU was trying to execute when it locked up (probably an 
illegal one). At that point RESET can be pushed by itself to 

do a normal warmstart. 


5) P command enhancement: 


The trace turned on by the P command can now be redirected to 

any output device. If it is desired to output to something other 
than the printer, store the device specification someplace in 
memory and point $105 to that location. The P command will then 
Open up an I/O channel to that device and the next P command 

Will close it. For example, 1f you were to store 'D:TEMP ' (notice 
the blank used as a terminator) at $600 and store OO O6 at 3105, 
the P command would open up a disk file. This feature is especially 
useful in conjunction with the disassembler or the Single-step. 


